home *** CD-ROM | disk | FTP | other *** search
/ ASP Advantage 1994 2nd Q2 / The Association of Shareware Professionals - The Official ASP Advantage (2nd Quarter)(1994).bin / contents / lprint.doc < prev    next >
Text File  |  1993-08-11  |  10KB  |  204 lines
  1.  LPRINT.EXE  - Printer module for Shareware Solutions.
  2.  Copyright 1993 Advantage Plus Dist., Inc.  All rights reserved.
  3.  
  4.  
  5.  DESCRIPTION
  6.  
  7.      The LPRINT program is a compact module designed to print program labels
  8.  on tractor feed label stock.  The program can be called from either the 
  9.  SSLIB or COPYCAT program.  It can also be called from batch files or custom
  10.  programs to print multiple copies of program labels.  It is called by using 
  11.  the /B switch in copycat and by using the filename to execute feature in 
  12.  the SSLIB setup program.
  13.  
  14.      LPRINT allows you to create your own labels.  You may use any number of
  15.  lines and make the lines any length.  You can mix printer codes anywhere
  16.  on a label line to create mixed font labels and special characters.  The 
  17.  program sends printer codes you enter so any tractor feed printer is 
  18.  supported.
  19.  
  20.      By creating special purpose batch files you can have the LPRINT module
  21.  print as many copies of a program label as you desire without having to 
  22.  copy the program each time.
  23.  
  24.      The LPRINT program incorporates "self modifying code".  This feature
  25.  allows it to store all configuration information internally.  By not
  26.  having separate configuration files you can have multiple copies of LPRINT
  27.  each having a different configuration.  This way you can keep different
  28.  copies of LPRINT for the different labels you print.  Note: It is very
  29.  IMPORTANT that you do not rename LPRINT until after it has been configured.
  30.  It cannot modify it own code unless it's name is LPRINT.EXE.  After it has
  31.  been configured it can be renamed and/or compressed using an EXE compress-
  32.  or such as LZEXE or PKLITE.
  33.  
  34.  
  35.  HOW IT WORKS
  36.  
  37.      The LPRINT program is called by passing it two parameters: /R and /P.
  38.  The /R switch is the RPT filename.  Ex: /Raccoting would be the ACCOTING.RPT
  39.  file.  The /P switch is the program number.  Ex: /P1660.  Both the SSLIB
  40.  program and the COPYCAT program pass these parameters in the %2 and %6 
  41.  variables.
  42.  
  43.  
  44.      The program must be setup before it can be used.  To access setup run 
  45.  the program with no command line parameters.
  46.  
  47.      The program outputs 5 pieces of label information and can accept any 
  48.  printer codes.  Label variables are preceded by the ~ and printer codes 
  49.  by the @.
  50.  
  51.   ~F ilename            - The descriptive filename
  52.   ~D escription         - The full description
  53.   ~N umber of disks     - 1 of 3, 2 of 3 etc...
  54.   ~P rogram number      - The program's file number
  55.   ~C ategory filename   - Category or RPT filename
  56.  
  57.    The following is a list of standard Epson printer codes.  They will
  58.  work for most Epson compatible printers.  If these codes do not work
  59.  you should check your printer's manual for printer codes specific to
  60.  your printer.   Printer codes must be preceded by the @ character and 
  61.  entered as decimal numbers.  They must be delimited by the - symbol.  
  62.  Ex: @27-15
  63.     
  64.    @27-15    - Compressed print on            @27-69    - Emphasized on        
  65.    @27-18    - Compressed print off           @27-70    - Emphasized off        
  66.    @27-52    - Italics on                     @27-119-1 - Double high on        
  67.    @27-18    - Italics off                    @27-119-0 - Double high off        
  68.    @27-87-1  - Double width on                @27-45-1  - Underlining on        
  69.    @27-87-0  - Double width off               @27-45-0  - Underlining off
  70.     
  71.    Printer codes can be entered on any line and mixed with label variables 
  72.  and literal text data.  Each printer code must be preceded by the @
  73.  character and the ESC code (27).  See LPRINT.DOC for more detailed 
  74.  instructions.  
  75.  
  76.    Tips on setting up labels:
  77.  
  78.    1.   The easiest way to print a full description label is to place a
  79.         single compressed print command in the Printer Setup field.  This 
  80.         will cause all fields to be printed in compressed print. You need
  81.         only to format the fields so they can fit on your labels.
  82.    
  83.    2.   When you turn a print feature on make sure you turn it off at some
  84.         point.  If you do not the printer will remain in it's current
  85.         state and print incorrectly on the next label.
  86.  
  87.    3.   Be sure to include all necessary information on the label including
  88.         the program name, number of disks, program number, and/or the
  89.         description.
  90.  
  91.    4.   When printing the full description the program will automatically
  92.         print each line correctly.  The first description line will contain
  93.         as much of the description as it will hold, the second description
  94.         line will begin where the first ended and so on.  Make sure you use 
  95.         enough description lines to allow the entire full description to 
  96.         print.
  97.  
  98.    5.   If you use the Double-high feature available on some printers you
  99.         can make the title line larger without changing the length of the 
  100.         line.  This means everything will fit even if you use compressed 
  101.         or subscript printing.
  102.  
  103.  
  104. Following are some example setup configurations:
  105.  
  106.  
  107. EXAMPLE #1
  108.  
  109. LPRINT.EXE - Shareware Solutions Printing Module.  Current configuration:
  110. ────────────────────────────────────────────────────────────────────────────────
  111. <A> Printer setup string: @27-15            <C>  Characters per line: 70   
  112. <B>      Number of lines: 8                 <D>     Printer LPT port: 1
  113. <1>  Line: ~F  -  ~P
  114. <2>  Line: ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀ 
  115. <3>  Line: ~D  
  116. <4>  Line: ~D  
  117. <5>  Line: ~D  
  118. <6>  Line: ~D  
  119. <7>  Line: ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀  
  120. <8>  Line: Shareware Solutions 919-362-8212   ~N  
  121. ────────────────────────────────────────────────────────────────────────────────
  122.  
  123.      This configuration would print a 8 line label.  The printer set-up 
  124.  string would set the printer into compressed print mode so the entire label 
  125.  would be printed compressed.  Each line would have a maximum of 70 char-
  126.  acters.  The high ASCII character ▀ (ALT-223) is used as a delimiter line 
  127.  for the label header and footer.  The FILENAME and PROGRAM NUMBER is on line 
  128.  1, DESCRIPTION is on lines 3-6 and the NUMBER OF DISKS is on line 8.  This 
  129.  configuration mimics the Full description 5 1/4 inch (4x1 x 7/16) label 
  130.  printed by the SSLIB program.
  131.  
  132.      This label is preconfigured in the copy of the LPRINT.EXE program that
  133.  has been renamed FULL5.EXE.  You may use this configuration by calling
  134.  FULL5.EXE from the SAMPLE.BAT file.
  135.  
  136.  
  137. EXAMPLE #2
  138.  
  139. LPRINT.EXE - Shareware Solutions Printing Module.  Current configuration:
  140. ────────────────────────────────────────────────────────────────────────────────
  141. <A> Printer setup string: @27-15            <C>  Characters per line: 41   
  142. <B>      Number of lines: 17                <D>     Printer LPT port: 1
  143. <1>  Line: ~F  -  ~P
  144. <2>  Line: ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀ 
  145. <3>  Line: ~D  
  146. <4>  Line: ~D  
  147. <5>  Line: ~D  
  148. <6>  Line: ~D  
  149. <7>  Line: ~D  
  150. <8>  Line: ~D  
  151. <9>  Line: ~D  
  152. <10> Line: ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀  
  153. <11> Line: Shareware Solutions 919-362-8212   ~N  
  154. <12> Line:
  155. <13> Line:
  156. <14> Line:
  157. <15> Line:
  158. <16> Line:
  159. <17> Line:
  160. ────────────────────────────────────────────────────────────────────────────────
  161.  
  162.      This configuration would print an 11 line label.  The blank lines would
  163.  position the printer for the next label.  The printer set-up string would 
  164.  set the printer into compressed print mode so the entire label would be 
  165.  printed compressed.  Each line would have a maximum of 70 characters.  The 
  166.  high ASCII character ▀ (ALT-223) is used as a delimiter line for the label 
  167.  header and footer.  The FILENAME and PROGRAM NUMBER is on line 1, DESC-
  168.  RIPTION is on lines 3-6 and the NUMBER OF DISKS is on line 8.  This config-
  169.  uration mimics the Full description 3 1/2 inch (2 & 3/4 x 2 & 3/4) label 
  170.  printed by the SSLIB program.
  171.  
  172.      This label is preconfigured in the copy of the LPRINT.EXE program that
  173.  has been renamed FULL3.EXE.  You may use this configuration by calling
  174.  FULL5.EXE from the SAMPLE.B